home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / wctoday.zip / WCTODAY.DOC < prev    next >
Text File  |  1991-08-01  |  14KB  |  313 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                        Who Called Today?  Version 3.5
  11.  
  12.                     -= For Wildcat! 3.XX systems only =-
  13.  
  14.       Copyright (c) 1989,91 Boardwalk Software - All Rights Reserved.
  15.  
  16.                  Technical Support and the latest versions!
  17.  
  18.                    The Boardwalk!  (206) 941-3124  (DATA)
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  Who Called Today?  A bulletin/hello screen generator for Wildcat! BBS systems.
  30.  ─────────────────────────────────────────────────────────────────────────────
  31.  
  32.  
  33.   Disclaimer
  34.  
  35.   Boardwalk Software hereby disclaims all warranties relating to this product,
  36.   whether express or implied, including without limitation any implied
  37.   warranties of merchantability or fitness for a particular purpose. Boardwalk
  38.   Software cannot and will not be liable for any special, incidental,
  39.   consequential, indirect or similar damages due to loss of data or any other
  40.   reason, even if Boardwalk Software or an authorized Boardwalk Software agent
  41.   has been advised of the possibility of such damages.  In no event shall the
  42.   liability for any damages ever exceed the price paid for the license to use
  43.   software, regardless of the form and/or extent of the claim.  The user of
  44.   this program bears all risk as to the quality and performance of the
  45.   software.
  46.  
  47.   Copyright
  48.  
  49.   Regardless of the method of marketing used, WCToday is NOT in the "Public
  50.   Domain".  It is copyrighted by Dave Cody and Boardwalk Software.
  51.  
  52.   License
  53.  
  54.   Who Called Today? (WCToday) is a Shareware product.  As such, it is made
  55.   available to the general computing public for evaluation.  Users are
  56.   licensed to operate WCToday on their personal computers for the purpose of
  57.   test and evaluation on a trial basis for a limited trial period.  It is not
  58.   possible to reasonably define any definitive limits of a fair and equitable
  59.   time period for evaluation, therefore, it is left to the user's decision as
  60.   to its usefulness.  If the user decides the program is not of sufficient
  61.   merit to warrant purchase through registration with Boardwalk Software, the
  62.   program should be removed from their personal computer.  Otherwise, if the
  63.   program is deemed useful and is in regular use on the user's personal
  64.   computer system, registration with Boardwalk Software is required.
  65.  
  66.   Registration
  67.  
  68.   You may register WCToday by sending the enclosed REGISTER.DOC along with a
  69.   check in the amount of $10.00 to Dave Cody at the address listed below:
  70.  
  71.  
  72.                                 Dave Cody
  73.                                 P.O. Box 99948
  74.                                 Tacoma, WA 98499
  75.  
  76.   WASHINGTON RESIDENTS MUST INCLUDE 8.2% SALES TAX.
  77.  
  78.  
  79.   Technical Support
  80.  
  81.   Comments and suggestions about WCToday are welcome as well as any comments
  82.   or suggestions that you may have in terms of additional utilities you would
  83.   like to see written.  Please call The Boardwalk! at (206) 941-3124. I can
  84.   also be reached via Fidonet at 343/47 and Mustang Software Support BBS.
  85.  
  86.  
  87.  
  88.  Who Called Today?  A bulletin/hello screen generator for Wildcat! BBS systems.
  89.  ─────────────────────────────────────────────────────────────────────────────
  90.  
  91.  
  92. A sample of the output
  93.  
  94. ┌─────────────────────────────────────────────────────────────────────────────┐
  95. │                  The Boardwalk! presents Who Called Today!                  │
  96. │                                                                             │
  97. │                                           Last   ┌Todays Totals────────┐    │
  98. │ L Caller              Calling From       Called  Calls Time Dls Uls Msgs    │
  99. └─────────────────────────────────────────────────────────────────────────────┘
  100.   2 JIM BREWER          New Port Richey, FL 15:29     2   13   10   0   5
  101.   1 DAVE MCKILLOP       Des Moines, WA      18:53     2   33    1   0   0  NC
  102.   1 CHIP NORTH          Torrence, CA        19:11     1    4    2   0   1  N
  103.   2 MARC HUFNAGEL       Murphysboro, IL     19:24     1    5    0   2   2
  104.  
  105.    Activity for 04-03-91 includes 6 call(s) for 0 hour(s) and 55 minute(s).    
  106. ┌─────────────────────────────────────────────────────────────────────────────┐
  107. │ Downloads: 13  Uploads:  2  Messages:  8  Drop Carriers:  1  New Users:  2  │
  108. └─────────────────────────────────────────────────────────────────────────────┘
  109.     WCToday 3.50 Copyright (c) 1989,91 by Dave Cody and Boardwalk Software
  110.  
  111.  
  112.   Operation
  113.  
  114.   WCToday is a hello screen/bulletin generator for Wildcat! BBS systems. The
  115.   program should be run after each caller logs off and will update the screen
  116.   that you choose to show a listing of all the callers to your system, on each
  117.   node, along with several pieces of statistical information.  Those are the
  118.   number of downloads, number of uploads, messages left, time on the system
  119.   and the last time called.  At the bottom of the display screen totals are
  120.   shown reflecting all caller statistics for the day.  As you can see from the
  121.   example I have included here that new callers to the system will be noted
  122.   with an N beside their name and callers who drop carrier during any call
  123.   will be noted with a C.
  124.  
  125.   A brief history... WCToday reads the activity log for it's data.  The
  126.   original program, Version 1, read from the beginning of the log to the end
  127.   of the log which took a considerable amount of time.  With Version 2 it
  128.   began reading from the end of the log backwards to the beginning of the
  129.   day's activity which speeded things up quite a bit.  Now, with Version 3,
  130.   WCToday will create a database and continue to add callers as the day goes
  131.   on so the program only has to read in the last caller each time, making it
  132.   extremely fast, as well as giving it true multi-node compatibility.
  133.  
  134.   Multi-node compatibility was the main reason for rewriting the program with
  135.   the intent to be able to create one output file that included the activity
  136.   on all nodes.  This feature is totally optional - it is configurable by the
  137.   Sysop - on a busy system this can be quite impressive.  Ease of use was
  138.   another reason for rewriting WCToday.  I have done away with the need to
  139.   place the complete path of the output file on the command line.  All input
  140.   and output options are simple command line switches as explained below.
  141.  
  142.   NOTE:  Run WCToday with no parameters to see a brief synopsis of these
  143.   command line switches.  Also, WCToday will only create the .SCR files if
  144.   you have specified that you are offering ANSI menus in Makewild.
  145.  
  146.  
  147.  
  148.  Who Called Today?  A bulletin/hello screen generator for Wildcat! BBS systems.
  149.  ─────────────────────────────────────────────────────────────────────────────
  150.  
  151.  
  152.   Switches
  153.  
  154.   Case is not important but each switch must be separated by a space.
  155.  
  156.   /L - Scan Last
  157.  
  158.   Scans the activity log for the last callers statistics, adds the caller to
  159.   the database, and creates the specified display file.  If the caller is
  160.   already in the database their statistics will be modified to reflect their
  161.   totals for the day.  A caller will have more than one entry in the database
  162.   by calling more than one node.  An entry will be added for each node.
  163.   WCToday will also reset automatically after on the first caller after
  164.   midnight so there is no special nightime maintainence mode to run.
  165.  
  166.   /A, A+ - Scan All
  167.  
  168.   Scans the entire days activity for all callers and recreates the database.
  169.   You would normally use this switch only the first time you run the program
  170.   or any time you want to start it over.
  171.  
  172.   By adding the "+" to this command line switch WCToday will not kill the
  173.   database allowing you to "add" the callers from other nodes.  If you run a
  174.   multi-node system you will first run WCToday with the "/A" parameter from
  175.   Node1 and then run it with the "/A+" parameter from all other nodes you wish
  176.   to include in the display file.
  177.  
  178.   NOTE:  If you do not specify an output file with one of the following
  179.   switches, WCToday will create the files WCTODAY.BBS/SCR in the Node Home
  180.   directory from which it is run.  This could be useful if you did not want to
  181.   create a conventional display file but wanted to see view the statistics.
  182.  
  183.   /H# - create a HELLO file using the #
  184.  
  185.   WCToday will look at you Wildcat! configuration and create a HELLOXX screen
  186.   in the proper path for "Display" files.  Range can be 1 to 10.
  187.  
  188.   /B# - create a BULLETIN file using the #
  189.  
  190.   WCToday will look at you Wildcat! configuration and create a BULLXXXX screen
  191.   in the proper path for "Bulletin" files.  Range can be 1 to 1000.
  192.  
  193.   NOTE:  The first time you run the program you will need to use either the /L
  194.   or /A switch in order to place some callers in the database, but after that
  195.   you can use the /H# or /B# to create just the display file if you like. If
  196.   there are no callers or if the program has not been run with the /L or /A
  197.   the output file will have the following line in it instead of callers names.
  198.  
  199.               Congratulations!  You are the first caller today!
  200.  
  201.   /E# - Exclude all callers at security level #.
  202.  
  203.   By default, WCToday will show the activity of all callers in the display
  204.   file, but if you do not want to show a specific security level you can force
  205.   it by using this switch.  This switch will work for other levels.  For
  206.   instance, you could prevent all callers at level WC100 with /EWC100.  At the
  207.   present time you can only keep one security level at a time from displaying.
  208.  
  209.  
  210.  
  211.  
  212.  Who Called Today?  A bulletin/hello screen generator for Wildcat! BBS systems.
  213.  ─────────────────────────────────────────────────────────────────────────────
  214.  
  215.  
  216.   /S- - Turn off all noises.
  217.  
  218.   By default, WCToday will make a bit of noise if it encounters a problem. If
  219.   it bothers you you can turn it off with this switch.
  220.  
  221.   NOTE:  On a single node system the errors should be very infrequent, but on
  222.   a multi-node system you may, occasionally, encounter a database lock that
  223.   causes the program to abort.  More commonly there will be a conflict caused
  224.   by a caller on one node viewing the display file while another node is
  225.   trying to write to it.  If the noise bothers you, turn it off.
  226.  
  227.   /D- - Exclude the C for dropped carriers from the display.
  228.  
  229.   By default, WCToday will place a C next to a callers statistics line if they
  230.   have dropped carrier during the day.  Some Sysops do not want to show this
  231.   since some drop carriers are unavoidable.
  232.  
  233.   /T- - Swap baud rate for last call time.
  234.  
  235.   By default, WCToday will display the callers last logon time, but if for
  236.   some reason you don't want to show this or would rather show the baud rate
  237.   you can use this switch to change it.
  238.  
  239.   /N- - Multi-node privacy switch.
  240.  
  241.   This switch will allow you to create Node specific display files.  It will
  242.   force WCToday to only show the activity for the Node that calls the program.
  243.   WCToday will create the database in your user data directory with a number
  244.   on the end indicating the node it is from.
  245.  
  246.  
  247.   Setting up your batch file
  248.  
  249.   After you have created the database the first time with the /A parameter
  250.   (and the /A+ parameter if you are multi-node) you will run it after each
  251.   caller logs off with something like the following:
  252.  
  253.   WCTODAY /L /H2          Scans the last caller and creates the HELLO2.BBS/SCR.
  254.  
  255.   WCTODAY /L /B10         Scans the last caller and creates the BULL10.BBS/SCR.
  256.  
  257.   WCTODAY /L /B10 /T-     Scans the last caller and display baud rates instead
  258.                           of logon times.
  259.  
  260.   WCTODAY /L /H2 /E1000   Exclude the Master Sysop in the display file.
  261.  
  262.   WCTODAY /L /H2 /N       Create a HELLO2 file with only callers from this node.
  263.  
  264.  
  265.   There are too many combinations to show them all, but the idea was to make
  266.   the command line as clean as possible.  I hope we accomplished that.
  267.  
  268.  
  269.  
  270.  ─────────────────────────────────────────────────────────────────────────────
  271.  Who Called Today?  A bulletin/hello screen generator for Wildcat! BBS systems.
  272.  
  273.  
  274.   POSTCALL.BAT
  275.  
  276.   You will need to create a file called Postcall.bat that will be called by
  277.   Wildcat! by default when a caller exits.  I have included a sample for you.
  278.  
  279.  
  280.   Acknowledgements
  281.  
  282.   WCToday was written in Turbo Pascal v6.0 from Borland International with
  283.   additional help from Turbo Power Software in Scotts Valley, CA in the use
  284.   of their outstanding Btree Filer and Object Professional libraries for
  285.   Turbo Pascal.  And of course, none of this would have been possible (or
  286.   necessary) without Mustang Software and their excellent bulletin board
  287.   program - Wildcat!.  Thank you!
  288.  
  289.  
  290.  
  291.   Other programs by Boardwalk Software
  292.  
  293.   The Master Series - File Master, User Master, and Message Master
  294.                       Wildcat! database managers for Wildcat! v2.XX
  295.  
  296.   Purge             - Purge your activity log of local and Sysop logons.
  297.  
  298.   Lopper            - "Lop" off your activity log based on a number of days.
  299.  
  300.   WCToday1          - An early version of WCToday for WC! Test-Drive
  301.  
  302.   WCToday2          - An early version of WCToday for WC! v2.00
  303.  
  304.   Authenticity Verification
  305.  
  306.   This archive has been zipped using Boardwalk Software's authenticity
  307.   verification number from PKWare.  If there are any files in the archive that
  308.   do not have the verification tag beside them it indicates that the archive
  309.   has been tampered with and is not in it's original form.  If this is the
  310.   case, please call the support bbs - The Boardwalk! - and get a clean copy.
  311.  
  312.  
  313.